
./" CODE BY KYLE CLEMENS
./" COPYRIGHT KYLE CLEMENS 2011
./" DISTRIBUTED UNDER TERMS OF THE GNU GPL V3


.TH DL 7 "v\ 1.18" "Mon, January 31, 2011" "dl Manual"
.SH NAME
.B dl
\- simple file downloader
.SH SYNOPSIS
dl [-hmzPv] [-d directory] [-a appendages] [-p parts] [-c bytes] [-s starting part] [-o name] URL ...
.br
.SH DESCRIPTION
dl is a file downloader designed for ease of use. It can download files that are in parts on a web server. So it will grab part1.rar through part14.rar. It downloads to the directory that it is called from. dl uses curl to download files, but it simplifies the nature of it so there aren't too many options.
.br
.SH OPTIONS
.TP
.B -h, --help
Shows a simple help dialog.
.TP
.B -v, --version
Display installed version
.TP
.B -m, --multi-part
Enables Multi-Part mode.
.TP
.B -P, --progress
Enables a progress bar instead of text progress.
.TP
.B -c, --continue=
Set what byte to begin downloading requested file from. This option defaults to zero (0). This option also works to continue downloading, if you stopped downloading at 1,000,124 bytes, enter 'dl http://example.com/somefile -c 1000124' and the download will finish.
.TP
.B -o, --output=
Sets the file name to output to.
.TP
.B -p, --parts=
Set number of parts to download. This only applies when in Multi-Part mode.
.TP
.B -z, --leading-zero
Tell dl that a leading zero is needed for part numbers that are single digit. This only applies when in Multi-Part mode.
.TP
.B -s, --starting-part=
Sets the starting part, that is, sets the part number to start downloading from. This only applies when in Multi-Part mode.
.TP
.B -a, --appendages=
This sets any appendages. Shown in example 4, an appendage is something that comes after the file names of the downloaded parts. For example, http://www.example.com/part1of3.rar has the appendage 'of3'. The file extension is not included. This only applies in Multi-Part mode. An appendage is anything that comes after the part number (where it should be, but isn't) and anything that comes before the extension (not including the dot).
.TP
.B -d, --directory=
This sets the directory to download the requested file to. If the directory does not exist, dl will quit. The default value is the directory dl was called from. This option is available in both Multi-Part and single file download modes.
.SH EXAMPLES
Example 1:  dl 'http://www.example.com/index.html'
.br
This will download index.html and save it to the file index.html from the directory that dl is running in. It is always best to put URLs in single-quotes (\').
.P
Example 2:  dl -m --parts=13 'http://www.example.com/part.rar'
.br
This puts dl in Multi-Part mode, specifies that there are 13 parts, and tells dl what the URL syntax is. The URL syntax is very simple, all that you need to enter is the normal URL but when you come to the part number you have to leave it blank. For example, http://www.example.com/part1.rar becomes http://www.example.com/part.rar
.P
Example 3:  dl -o "Output.txt" -P -c 136 'http://www.example.com/story.txt'
.br
This tells dl that it should name the downloaded file 'Output.txt', show a progress bar, and start downloading from byte 136 of the file.
.P
Example 4:  dl -m -p 3 -a "of3" --leading-zero 'http://www.example.com/partof3.rar'
.br
This tells dl to be in Multi-Part mode, that it's downloading 3 parts, and there is an appendage that is 'of3'. Notice how the part number is still not there, even though there is 'of3' in the name. An appendage is anything that comes after the part number (where it should be, but isn't) and anything that comes before the extension (not including the dot).
.SH VERSION
This documentation describes
.B dl
version 1.18
.SH "SEE ALSO"
curl(1)
.br
.SH AUTHOR
.br
.B Kyle Clemens
.br
.I \<pippin418@gmail.com\>
